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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management, as identified below: 

32.341: "File Transfer (FT) Integration Reference Point (IRP): Requirements" 

32.342: "File Transfer (FT) Integration Reference Point (IRP): Information Service (IS)" 

32.343: "File Transfer (FT) Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORE A) Solution Set (SS)" 

32.345: "File Transfer (FT) Integration Reference Point (IRP): extensible Markup Language (XML) 

definitions" 

32.347: "File Transfer (FT) Integration Reference Point (IRP): SOAP Solution Set (SS)" 

The present document is part of a TS-family which describe the requirements and information model necessary for the 
Telecommunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 
3GPP TS 32.101 [1] and 3GPP TS 32.102 [2]. 

Network Elements (NEs) under management, element managers as well as network managers generate various 
management information stored in file format. This IRP is addressing how these files are exchanged through Itf-N as 
well as certain aspects of file management and maintenance. It is anticipated that management functions (e.g. PM, Call 
Trace, CM) make reuse of capabilities provided by this File Transfer IRP. 



ETSI 



3GPP TS 32.347 version 8.0.0 Release 8 5 ETSI TS 1 32 347 V8.0.0 (2009-04) 



Scope 



The present document specifies the SOAP Solution Set for the IRP whose semantics are specified in File Transfer IRP: 
Information Service (3GPP TS 32.342 [4]). 

This Solution Set specification is related to 3GPP TS 32.342 V8.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.341: " Technical Specification Group Services and System Aspects; 

Telecommunication management; File Transfer (FT) Integration Reference Point (IRP): 
Requirements ". 

[4] 3 GPP TS 32.342: " Technical Specification Group Services and System Aspects; 

Telecommunication management; File Transfer (FT) Integration Reference Point (IRP): 
Information Service (IS)". 

[5] 3GPP TS 32.345: " Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP): extensible Markup Language (XML) definitions". 

[6] 3GPP TS 32.31 1: "Teleconmiunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[8] 3GPP TS 32.317: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; SOAP solution set". 

[9] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[10] 3GPP TS 32.307: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): SOAP solution set". 

[II] W3C SOAP 1 . 1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 
[ 1 2] W3C XPath 1 .0 specification ( http://www.w3.org/TR/1999/REC-xpath-19991 1 16) 
[13] W3C WSDL 1.1 specification ( http ://www. w3 .org/TR/200 1/NOTE- wsdl-200 10315) 
[14] W3C SOAP 1.2 specification ( http://www.w3 .org/TR/soap 1 2-part 1/) 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.150 [9] and 3GPP TS 32.341 [3] and the following apply: 

IRP document version number string (or "IRPVersion"): See 3GPP TS 32.311 [6]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

IS Information Service 

SS Solution Set 

WSDL Web Service Description Language 



Architectural features 



4.1 General 

The overall architectural feature of the File Transfer (FT) IRP is specified in 3GPP TS 32.342 [4]. This clause specifies 
features that are specific to the SOAP solution set. 

The SOAP 1.1 specification [11] and WSDL 1.1 specification [13] are supported. 

The SOAP 1.2 specification [14] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [12]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 

The FT IRP SOAP SS uses the Notification IRP SOAP SS of 3GPP TS 32.307 [10]. The IRPAgent shall support the 
push interface model, which means that the IRPAgent sends FT notifications to the IRPManager as soon as new events 
occur. The IRPManager does not need to check ("pull") for events. 

Relevant definitions are imported from the FT IRP XML definitions of 3GPP TS 32.345 [5]. 

This specification uses a number of namespace prefixes throughout that are listed in Table 4.1. 

Table 4.1 : Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http://schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


fllRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32 series/32. 347#FTIRPSystem 


fllRPData 


http://www.3gpp.org/ftp/Specs/archive/32 series/32. 347#FTIRPData 


xfi 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 345#fTIRPIOCs 


genericlRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32 series/32.31 7/schema/3231 7-81 0/GenericlRPSystem 


ntflRPNtfSystem 


http://www.3gpp.org/ftp/Specs/archive/32_series/32.307/schema/32307- 
810/notification/NotificationlRPNtfSystem 
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The WSDL structure is depicted in Figure 4.1 below, depicting port type, binding and service. The port type contains 
port type operations, which again contains input, output and fault messages. The binding contains binding operations, 
which have the same name as the port type operations. The binding connects to a port inside the service. 
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Figure 4.1 : File Transfer IRP SOAP Solution Set WSDL structure 



5 Mapping 

5.1 Operation and notification mapping 

The FT IRP IS (3GPP TS 32.342 [4]) defines the operations and their semantics. 

Table 5.1 maps the operations defined in the FT IRP IS to their equivalent port type and binding operations in this 
Solution Set (SS). 

Table 5.1 also maps the notifications of the FT IRP IS, as well as inherited operations. 

Table 5.1 also qualifies if an operation is Mandatory (M) or Optional (O). 

Table 5.1 : Mapping from IS Operation to SS Equivalents 



IS Operation in 3GPP TS 32.342 [4] 


SS: Operation for WSDL port 
type and WSDL binding 


SS: Port of 
FileTransferlRPService 


Qualifier 


listAvailableFiles 


listAvailableFiles (note 1) 


FileTransferlRPPort 


M 


fileDownloadlndication 


fileDownloadlndication (note 1) 


FileTransferlRPPort 





notifyFileReady 


notify (note 2) 


NotificationlRPNtfPort 


M 


notifyPilePreparationError 


notify (note 2) 


NotificationlRPNtfPort 


M 


getlRPVersion (note 3) 


See TS 32.317 [8] 


GenericIRPPort 


M 


getOperationProfile (note 3) 


See TS 32.317 [8] 


GenericIRPPort 





getNotificationProfile (note 3) 


See TS 32.317 [8] 


GenericIRPPort 





NOTE 1 : The operation is under the port type fTIRPSystem:FileTransferlRPPortType and under the binding 
fTIRPSystem:FileTransferlRPBinding. 


NOTE 2: The IS equivalent maps to an XML definition specified in 3GPP TS 32.345 [5], and this being an input 
parameter to the operation notify under the port type ntflRPNtfSystem:NotificationlRPNtf and under the 
binding ntflRPNtfSystem:NotificationlRPNtf of 3GPP TS 32.307 [1 0]. This binding is linked to a port of the 
FileTransferlRPService as indicated in the table above. 


NOTE 3: The IS operation is inherited from the ManagedGenericIRP IOC specified in 3GPP TS 32.312 [7]. 
This inheritance is by the FileTransferlRP IOC of 3GPP TS 32.342 [4] inheriting from the 
ManagedGenericIRP IOC. The corresponding binding is linked to a port of the FileTransferlRPService as 
indicated in the table above. 
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5.2 Operation parameter mapping 

The FT IRP IS (3GPP TS 32.342 [4]) defines semantics of parameters carried in the operations. The tables below show 
the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

5.2.1 Operation listAvailableFiles 

5.2.1 .1 Input parameters 

Table 5.2.1.1: Mapping from IS listAvailableFiles input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


managementDataType 


managementDataType 


M 


beginTime 


beginTime 


M 


endTime 


endTime 


M 



5.2.1 .2 Output parameters 

Table 5.2.1.2: Mapping from IS listAvailableFiles output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


f ilelnfoList 


f ilelnfoList 


M 


status 


status 


M 



5.2.1.3 Fault definition 

Table 5.2.1.3: Mapping from IS listAvailableFiles exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


invalidTimes 


InvalidTimes 


M 



5.2.2 Operation f ileDownloadlndication 

5.2.2.1 Input parameters 

Table 5.2.2.1 : Mapping from IS fileDownloadindication input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


f ilelnfoList 


f ilelnfoList 


M 
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5.2.2.2 Output parameters 

Table 5.2.2.2: Mapping from IS fileDownloadindication output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


status 


status 


M 



5.2.2.3 Fault definition 

Table 5.2.2.3: Mapping from IS fileDownloadindication exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


InvalidFilelnfoList 


InvalidFilelnfoList 


M 
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Annex A (normative): 
WSDL specifications 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! -- 

3GPP TS 32.347 File Transfer (FT) IRP SOAP Solution Set 
- - > 

<def initions xmlns="http: //schemas .xmlsoap.org/wsdl/" 
xmlns : soap="http: //schemas .xmlsoap.org/wsdl/soap/" 

xmlns : f TIRPSystem= "http : //www . 3gpp . org/f tp/Specs/archive/32_series/32 . 347#FTIRPSystem" 
xmlns : f TIRPData= "http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 347#FTIRPData" 
xmlns :xf i="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 345#fTIRPIOCs" 

xmlns :genericIRPSystem="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
810/GenericIRPSystem" 

xmlns :ntfIRPNtfSystem="http: //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 307/schema/32307- 
8 10/not if icat ion/Not if icationlRPNtf System" 
targetNamespace="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 347#FTIRPSystem" > 

<import namespace="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 307/schema/32307- 
810/notif icat ion/Not if icationlRPNtf System" 
location="http: //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 3 07/schema/323 07-810-wsdl . zip"/> 

<import namespace="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
810/GenericIRPSystem" location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 317/schema/32317- 
810-wsdl . zip"/> 
<types> 

< schema targetNamespace="http : //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 34 7#FTIRPData" 
xmlns="http : //www. w3 . org/2 OOl/XMLSchema" > 

<import namespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 345#fTIRPIOCs"/> 
<!-- The following types are defined for the File Transfer IRP operations --> 
<simpleType name="OperationStatusTwo" > 
<restriction base="string" > 

<enumeration value="OperationSucceeded"/> 
<enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 

<complexType name="FileInf o" > 
<sequence> 

<element ref ="xf i : f ileLocation"/> 
<element ref ="xf i : f ileSize"/> 
<element ref ="xf i : f ileReadyTime"/> 
<element ref ="xf i : f ileExpirationTime"/> 
< element ref ="xf i : f ileCompression"/> 
< element ref ="xf i : f ileFormat"/> 
</sequence> 
</complexType> 

<complexType name="FileInf oList " > 
<sequence> 

<element name="f ilelnf o" type="fTIRPData : Filelnf o" minOccurs="0" 
maxOccurs= " unbounded" / > 

</sequence> 
</complexType> 

<!-- listAvailableFiles Request--> 
<element name= " listAvailableFiles " > 
<complexType> 
<sequence> 

<element ref ="xf i :managementDataType"/> 

<element name="beginTime" type="dateTime" minOccurs=" 0"/> 
<element name="endTime" type="dateTime" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- listAvailableFiles Response --> 
<element name= " listAvailableFilesResponse" > 
<complexType> 
<sequence> 

<element name= " filelnf oList " type= " f TIRPData : Filelnf oList " /> 
< element name= " status " type= " f TIRPData : Operat ionStatusTwo" / > 
</sequence> 
</complexType> 
</element> 

<!-- listAvailableFiles Fault --> 
<element name="listAvailableFilesFault " > 
<simpleType> 

<restriction base="string" > 

<enumeration value="InvalidTimes"/> 
</restriction> 
</simpleType> 
</element> 

<!-- f ileDownloadlndication Request- -> 
<element name= " f ileDownloadlndication" > 
<complexType> 
<sequence> 

<element name= " filelnf oList " type= " f TIRPData : Filelnf oList " /> 
</sequence> 
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</complexType> 
</element> 

<!-- f ileDownloadlndication Response --> 
<element name="f ileDownloadlndicationResponse" > 
<complexType> 
<sequence> 

< element name= " status " type= " f TIRPData : Operations tatusTwo " / > 
</sequence> 
</complexType> 
</element> 

<!-- f ileDownloadlndication Fault --> 
<element name= " f ileDownloadlndicationFault " > 
<simpleType> 

<restriction base="string" > 

<enumeration value= " InvalidFileInf oList " /> 
< /restrict ion> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name="listAvailableFiles" > 

<part name= "parameter" element= " f TIRPData : listAvailableFiles " /> 
</message> 
<message name="listAvailableFilesResponse" > 

<part name= "parameter" element= "f TIRPData : listAvailableFilesResponse"/> 
</message> 
<message name= " listAvailableFilesFault " > 

<part name= "parameter" element= " f TIRPData : listAvailableFilesFault " /> 
</message> 
<message name= " f ileDownloadlndication" > 

<part name= "parameter" element= " f TIRPData : f ileDownloadlndication" /> 
</message> 
<message name="f ileDownloadlndicationResponse" > 

<part name= "parameter" element= "f TIRPData : f ileDownloadlndicationResponse" /> 
</message> 
<message name= " f ileDownloadlndicationFault " > 

<part name= "parameter" element= " f TIRPData : f ileDownloadlndicationFault " /> 
</message> 

<portType name="FileTransf erIRPPortType" > 
<operation name="listAvailableFiles" > 

<input message="fTIRPSystem: listAvailableFiles"/> 
<output message="fTIRPSystem: listAvailableFilesResponse"/> 

<f ault name= "listAvailableFilesFault " message= " f TIRPSystem : listAvailableFilesFault " /> 
</operation> 
<operation name= " f ileDownloadlndication" > 

<input message="f TIRPSystem: f ileDownloadlndication" /> 
< output message="f TIRPSystem: f ileDownloadIndicationResponse"/> 
<fault name="f ileDownloadlndicationFault" 
message= " f TIRPSystem : f ileDownloadlndicationFault " /> 
</operation> 
< /port Type > 
<binding name="FileTransf erIRPBinding" type= "f TIRPSystem : FileTransf erIRPPortType" > 

<soap : binding style= "document " transport= "http : //schemas . xmlsoap . org/soap/http" /> 
<operation name="listAvailableFiles" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 347#listAvailableFiles" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<f ault name= "listAvailableFilesFault " > 

<soap: fault name="listAvailableFilesFault" use="literal"/> 
</fault> 
</operation> 

<operation name= " f ileDownloadlndication" > 
<soap : operation 
soapAction= "http : //www . 3gpp . org/f tp/Specs/archive/32_series/32 . 347#f ileDownloadlndication" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
< /output > 
<f ault name= " f ileDownloadlndicationFault " > 

<soap : fault name= " f ileDownloadlndicationFault " use= "literal " /> 
</fault> 
</operation> 
</binding> 
<service name="FileTransf erIRPService" > 

<port name= " FileTransf erIRPPort " binding= " f TIRPSystem : FileTransf erIRPBinding" > 
<soap: address 
location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 347#FileTransf erIRP"/> 
</port> 
<port name="GenericIRPPort" binding="genericIRPSystem:GenericIRPBinding" > 
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<soap: address 
location="http: //www. 3gpp.org/ftp/Specs/archive/32_series/32 . 317#GenericIRP"/> 
</port> 

<port name="Notif icationlRPNtfPort" binding="ntf IRPNtf SystemrNotif icationlRPNtf " > 
<soap: address 
location="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 307#Notif icationlRPNtf "/> 
</port> 
</service> 
</def initions> 



Annex B (informative): 
WSDL electronic files 



The electronic files corresponding to the normative WSDL/XML schema defined in the present document are available 
in native form in the following archive: 

http://www.3gpp.org/ftp/Specs/archive/32_series/32.347/schema/32347-800-wsdLzip 
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